# For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html

# Sets the minimum version of CMake required to build the native library.
# CMake最小版本使用的是3.4.1。
cmake_minimum_required(VERSION 3.4.1)

# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.
# 配置so库信息（为当前当前脚本文件添加库）。主要目的是为了创建库。
add_library( # Sets the name of the library.
             # 这个是声明引用so库的名称，在项目中，如果需要使用这个so文件，引用的名称就是这个。
             # 值得注意的是，实际上生成的so文件名称是libnative-lib。当Run项目或者build项目是，
             # 在Module级别的build文件下的intermediates\transforms\mergeJniLibs\debug\folders\2000\1f\main下会生成相应的so库文件。
             native-lib

             # Sets the library as a shared library.
             # STATIC：静态库，是目标文件的归档文件，在链接其它目标的时候使用。
             # SHARED：动态库，会被动态链接，在运行时被加载。
             # MODULE：模块库，是不会被链接到其它目标中的插件，但是可能会在运行时使用dlopen-系列的函数动态链接。
             SHARED

             # Provides a relative path to your source file(s).
             # 构建so库的源文件。
             src/main/cpp/native-lib.cpp )

# Searches for a specified prebuilt library and stores the path as a
# variable. Because CMake includes system libraries in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.
# 这个方法与我们要创建的so库无关而是使用NDK的Apis或者库，默认情况下Android平台集成了很多NDK库文件，
# 所以这些文件是没有必要打包到apk里面去的。直接声明想要使用的库名称即可（猜测：貌似是在Sytem/libs目录下）。
# 在这里不需要指定库的路径，因为这个路径已经是CMake路径搜索的一部分。如示例中使用的是log相关的so库。
find_library( # Sets the name of the path variable.
              # 这个指定的是在NDK库中每个类型的库会存放一个特定的位置，而log库存放在log-lib中
              log-lib

              # Specifies the name of the NDK library that
              # you want CMake to locate.
              # 指定使用log库
              log )

# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.
# 如果你本地的库（native-lib）想要调用log库的方法，那么就需要配置这个属性，意思是把NDK库关联到本地库。
target_link_libraries( # Specifies the target library.
                       # 要被关联的库名称
                       native-lib

                       # Links the target library to the log library
                       # included in the NDK.
                       # 要关联的库名称，要用大括号包裹，前面还要有$符号去引用。
                       ${log-lib} )